home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr18 / ter99.zip / DOCS._XE / ANSMUSIC.DOC next >
Text File  |  1992-09-20  |  5KB  |  132 lines
  1.  
  2.                                ANSI MUSIC
  3. ──────────────────────────────────────────────────────────────────────────────
  4.  
  5.  
  6. This is the specifications Terminate follows, if you are a sysop you
  7. could include ansi music in your menus and then users that uses
  8. Terminate or another terminal program could here melodies or fancy
  9. tunes when they enter the menu. Other terminal program will just
  10. skip the codes, nothing else will happend. Maybe it will look weird
  11. on your screen, because your BBS system does not understand the codes.
  12. But it does'nt matter at all.
  13.  
  14. I use this little code in my LOGO.ANS (Remote Access file shown at login):
  15.  
  16. MB O3 T120 L2CO4CO3L6BGABO4L2CO3L2CL2AL1GL2CFL4EL6CDEL4FL3DL6O2BO3CDL4EL2C
  17.  D
  18.  
  19. As you can see i clears the screen ([2J), right after the sound codes so
  20. programs that does not support ansi music won't see the codes.
  21.  
  22. It's really simple to create this music. Hopefully many more will start
  23. using those codes inside online games etc.
  24.  
  25. Small examples:
  26.  
  27. MB O3     Sets octave 3
  28. MB T120   Sets tempo to 120 (default)
  29.  
  30. You can use several statements on each line. Could it be more simple.
  31. It's exactly the same command as the BASIC command called PLAY from
  32. IBM BASIC or GW-BASIC and all those.
  33.  
  34. ------------------------------------- CUT -------------------------------------
  35.  
  36.          MUSIC:
  37.  
  38.           Syntax: ESC[MF T120 O2C8D8E8F8G8 (All lines must end with ASCII 14)
  39.  
  40.           Music strings in the BASIC Play format are supported.
  41.           Multiple strings per line may be entered.
  42.  
  43.           Music strings should begin with the characters "<esc>[M"
  44.           where <esc> is a true ESC character (DEC 27, Hex 1B).
  45.           Please refer to your BASIC manual for information on the
  46.           BASIC Play commands.  The following are all valid for
  47.           beginning a Music string in SMILE: MF, MB, MN, ML, MS, M .
  48.           Although MB (Music Background) is valid, true backgroud
  49.           music is NOT supported.
  50.  
  51.           Music strings should end with the musical note character
  52.           (DEC 14, Hex 0E, CTRL-N).  If this character is missing,
  53.           SMILE will look for the next ESC character or the
  54.           end-of-line marker to terminate the music string.  This
  55.           option was added to try and catch as many incorrectly
  56.           formated music strings as possible.  However, for
  57.           compatiblity with other viewers, I suggest you always end
  58.           your music strings with CTRL-N (DEC 14)
  59.  
  60.  
  61.  
  62.           SOUND:
  63.           ( Thanks to Julie Ibarra, author of ANSIPLAY for this idea )
  64.  
  65.           Syntax:
  66.           ESC[MF Freq; Duration; Cycles; CycleDelay;Variation (DEC14)
  67.  
  68.           Custom Sounds are supported in SMILE by using a SOUND CODE
  69.           similar to that found in BASIC and the program ANSIPLAY.
  70.           However, the SOUND generator in SMILE differs from the
  71.           SOUND command in BASIC.  Therefore, different frequency
  72.           values must be used to produce the musical notes.  These
  73.           are listed somewhere down the page.
  74.  
  75.           The SOUND statement must begin and end in the same manner
  76.           discussed above for a normal music string.  The SOUND CODE
  77.           consists of the following parameters serparated by a
  78.           semicolon (;) :
  79.  
  80.           FREQ     : Frequency of note to be played.  The affective
  81.                      range of frequencies is 0 to 7904.
  82.                      (0..65535)
  83.  
  84.           DURATION : Time, in milliseconds, the note should be played.
  85.                      (0..65535)
  86.  
  87.           CYCLES   : Number of times to repeat Frequency/Duration.
  88.                      (0..65535)
  89.  
  90.           DELAY    : Time, in milliseconds, between cycles.
  91.                      (0..65535)
  92.  
  93.           VARIATION: Frequency value is changed by this number for
  94.                      each CYCLE the note is played.
  95.                      (-65535..65535)
  96.  
  97.  
  98.           (NOTE: 1 second = 1000 milliseconds)
  99.  
  100.  
  101.           Press ESC to exit a DURATION or DELAY action.  You may
  102.           have to press ESC a couple of times to completely exit
  103.           a sound sequence.
  104.  
  105.           SOUND CODE Musical Note Frequency Values (7 Octives):
  106.  
  107.  
  108.             C    C#   D    D#   E    F    F#   G    G#   A    A#   B
  109.  
  110.             65   69   73   78   82   87   92   98  104  110  116  123
  111.            131  139  147  156  165  175  185  196  208  220  233  247
  112.            262  278  294  312  330  350  370  392  416  440  466  494
  113.            524  556  588  624  660  700  740  784  832  880  932  988
  114.           1048 1112 1176 1248 1320 1400 1480 1568 1664 1760 1864 1976
  115.           2096 2224 2352 2496 2640 2800 2960 3136 3328 3520 3728 3952
  116.           4192 4448 4704 4992 5280 5600 5920 6272 6656 7040 7456 7904
  117.  
  118.  
  119.           One advantage of the SOUND CODE is the ability to place a
  120.           PAUSE in your ANSI screens without having to use a
  121.           multitude of ESC[s codes.  Just use a SOUND CODE with the
  122.           DELAY set very high to get a pause.  For example,
  123.  
  124.           ESC[MF ;;;60000
  125.  
  126.           would pause your ANSI Screen for 60 seconds, or until a key
  127.           is pressed when viewing it with SMILE.  Remember, these
  128.           SOUND CODES are not supported by bulletin boards...(yet)!
  129.  
  130. ------------------------------------- CUT -------------------------------------
  131.  
  132.